代码中通过 来加载驱动，通过DriverManager.getConnection()来打开一个连接，驱动名为”org.h2.Driver”。数据库 URL 总是使用jdbc:h2:来标识，getConnection() 的第二个参数是用户名（ sa 作为系统超级管理员的一个例子），第三个参数是密码，用户名是不区分大小写，但是密码是大小写区分的。

创建新一个新数据库

缺省情况下，如果 URL 指定的数据库并不存在，一个新的空的数据库将被自动的创建。创建数据库的用户自动成为这个数据库的超级管理员。

自动创建新库也可以通过特殊的 URL 进行屏蔽，参见打开一个存在的数据库。

使用服务器模式

H2 目前支持三种服务器模式：web 服务器模式（H2 控制台）、TCP 服务器模式（C/S连接）和 PG 服务器模式（PostgreSQL 客户端）。可以通过多种方式启动服务器模式，通常的方式是通过Server工具。开启服务器无需开启数据库——数据库会在客户端连接时开启

缺省设置下，输入下面命令并执行能启动 Server 工具：

  1. java -cp h2*.jar org.h2.tools.Server

通过下面的命令行，可以查看服务器启动命令行的参数及缺省值：

  1. java -cp h2*.jar org.h2.tools.Server -?

参数允许服务器工具启动到其他端口或者只是部分启动。

连接到 TCP 服务器

为了能远程通过 TCP 服务器访问数据库，使用下面的连接驱动和数据库URL：

• JDBC驱动类： org.h2.Driver• 数据库URL: jdbc:h2:tcp://localhost/~/test

关于数据库 URL，可以查看《特性》这章。注意不能通过浏览器访问这个 URL ，只能通过 H2 客户端（通过 JDBC）。

在应用内部启动TCP服务

在JAVA应用内部，也可以通过代码来实现TCP服务的启动和停止，例子代码如下：

  1. import org.h2.tools.Server;
  2. ...
  3. // 启动 TCP Server
  4. Server server = Server.createTcpServer(args).start();
  5. ...
  6. // 关闭 TCP Server
  7. server.stop();

从其他程序关闭 TCP 服务器

可以从另外的程序关闭 TCP 服务器，使用下面命令行：

  1. java org.h2.tools.Server -tcpShutdown tcp://localhost:9092

在用户应用中关闭服务器，使用:

  1. org.h2.tools.Server.shutdownTcpServer("tcp://localhost:9094");

这个功能将仅仅关闭 TCP 服务器。如果相同的程序有其他服务器，他们不会被关闭，而是继续执行。为了避免覆盖在数据库下次打开时，在调用这个方法时，所有的到数据库的连接将会关闭。要实现远程关闭服务器，需启用远程连接。关闭一个 TCP 服务器可以通过选项 -tcpPassword 来保护 (启动和关闭 TCP 服务器也要用这个密码)

使用 Hibernate

H2 数据库支持 Hibernate 3.1及以上的版本。 你能够使用 HSQLDB 方言，或是 H2 自己的方言。注意的是，在 Hibernate 中包含的 H2 方言有BUG，针对这些 BUG 的补丁已经被发布和修复,见https://hibernate.atlassian.net/browse/HHH-3401。你能够将它改名为H2Dialect.java，直接把它包含在你的应用中即可使用，或者使用 已经修复了这个问题的 Hibernate 的版本。

当使用 Hibernate,尝试使用 H2Dialect 如果可能的话。当使用H2Dialect,兼容性模式比如MODE=MySQL是不支持的。当使用兼容模式时,使用 Hibernate 相应的数据库的方言，而不是 H2Dialect;但请注意 H2 不支持所有数据库的所有功能。

H2 数据库是兼容 HSQLDB 和 PostgreSQL。如果要使用 H2 的特殊属性，需要使用 H2Platform，源代码在src/tools/oracle/toplink/essentials/platform/database/DatabasePlatform.java.txt. 你将这个文件拷贝到你的应用中，并将它改名为 .java 的文件，并修改persistence.xml：

  1. <property
  2.     name="toplink.target-database"
  3.     value="oracle.toplink.essentials.platform.database.H2Platform"/>

旧版本的 Glassfish 的属性名为toplink.platform.class.name。

在 Glassfish 中使用 H2,拷贝 h2*.jar 到glassfish/glassfish/lib 目录

使用 EclipseLink

在 EclipseLink 使用 H2，可以通过类org.eclipse.persistence.platform.database.H2Platform。如果你使用的 EclipseLink 版本不支持，可以使用 OraclePlatform 替代，具体看 H2Platform

使用 Apache ActiveMQ

当使用 H2 作为 Apache ActiveMQ 的后端数据库,请使用TransactDatabaseLocker 而不是默认的锁机制。否则,数据库文件将没有界限的增长。原因是默认锁机制是使用一个未提交的 UPDATE 事务,使得事务日志不会收缩（造成数据库文件增长)。TransactDatabaseLocker 使用 SELECT ... FOR UPDATE 而不是使用一个 UPDATE 语句,来解决问题。使用它,改变 ApacheMQ 配置元素<jdbcPersistenceAdapter>元素,属性databaseLocker ="org.apache.activemq.store.jdbc.adapter.TransactDatabaseLocker"。然而,使用 MVCC 模式将再次导致同样的问题。因此,在这种情况下,请不要使用 MVCC 模式。另一个(更危险)解决方案是useDatabaseLock设置为 false。

在 NetBeans 中使用 H2

项目 允许您在 IDE 中启动和停止服务器 H2。

有一个已知问题当使用 Netbeans SQL Execution Window:在执行查询之前,另一个查询 SELECT COUNT(*) FROM <query> 运行。这是一个查询的问题会修改状态,如 SELECT SEQ.NEXTVAL。在这种情况下,两个序列值分配而不是一个。

jOOQ 添加一个 JDBC 薄层,允许 SQL 类型安全的建设,包括高级 SQL,存储过程和高级的数据类型。jOOQ 需要数据库模式作为基础代码生成。如果这是你的示例模式:

使用命令行来运行 jOOQ 代码生成器:

  1. java -cp jooq.jar;jooq-meta.jar;jooq-codegen.jar;h2-1.3.158.jar;.org.jooq.util.GenerationTool /codegen.xml

当 codegen.xml 在 classpath 并且包含了如下信息

  1. <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  3.     <jdbc>
  4.         <driver>org.h2.Driver</driver>
  5.         <user>sa</user>
  6.         <password></password>
  7.     </jdbc>
  8.     <generator>
  9.         <name>org.jooq.util.DefaultGenerator</name>
  10.         <database>
  11.             <name>org.jooq.util.h2.H2Database</name>
  12.             <includes>.*</includes>
  13.             <excludes></excludes>
  14.             <inputSchema>PUBLIC</inputSchema>
  15.         </database>
  16.         <generate></generate>
  17.         <target>
  18.             <packageName>org.jooq.h2.generated</packageName>
  19.             <directory>./src</directory>
  20.         </target>
  21.     </generator>
  22. </configuration>

使用生成的原件，可以执行如下查询s:

  1. Factory create = new H2Factory(connection);
  2. Result<UserRecord> result =
  3. create.selectFrom(USER)
  4.     .where(NAME.like("Johnny%"))
  5.     .orderBy(ID)
  6.     .fetch();

细节详见 jOOQ 主页 和

在 Web 应用中使用 H2 数据库

在 Web 应用中使用数据库，可以有多种方式，这里有一些针对 Tomcat 和 JBoss 的例子。

最简单（目前）的方法就是将数据库内嵌到应用中，这样就意味着应用启动的时候就打开了一个连接（好的办法是使用 Servlet 监听器，看下面的说明）。数据库能被多个 session 和应用访问，他们跟应用运行在一个进程内，大部分的 Servlet 容器只适用一个进程（如Tomcat），这些容器都是没有问题的（除非你使用集群）。Tomcat 使用多线程和多类加载器。如果多个应用同时访问同一个数据库，你需要将数据库的 jar 文件放在shared/lib或是server/lib目录。好的方案是 Web 应用启动时打开数据库，Web 应用停止时关闭数据库。如果是多个应用，只需要一个应用来处理启动和关闭。好的方案是一个 Session 一个连接，或者是一个请求（action）一个连接，连接使用完后尽可能的关闭它，当然不关闭并不会引起可怕的后果。

服务器模式

服务器模式是差不多的，但是它可以运行在其他的进程中。

使用 Servlet 监听去启动和停止数据库

增加 h2*.jar 文件到你的应用中，将下面的配置增加到你的 web.xml 中（在filter节下面的 context-param）：

  1. <listener>
  2.     <listener-class>org.h2.server.web.DbStarter</listener-class>
  3. </listener>
  1. Connection conn = getServletContext().getAttribute("connection");

DbStarter 也能够启动 TCP 服务，但是缺省状态下是不允许的。可以通过修改 web.xml 下的参数 db.tcpServer 来启用。下面是完整的配置选项，这些选项需要放在description标签和 listener/filter 标签中间：

  1. <context-param>
  2.     <param-name>db.url</param-name>
  3.     <param-value>jdbc:h2:~/test</param-value>
  4. </context-param>
  5. <context-param>
  6.     <param-name>db.user</param-name>
  7.     <param-value>sa</param-value>
  9. <context-param>
  10.     <param-name>db.password</param-name>
  11.     <param-value>sa</param-value>
  12. </context-param>
  13. <context-param>
  14.     <param-name>db.tcpServer</param-name>
  15.     <param-value>-tcpAllowOthers</param-value>

当 web 应用停止时，数据库连接将被自动关闭，如果通过 DbStarter 还启动了 TCP 服务，TCP 服务也将被自动关闭。

使用 H2 控制台 Servlet

H2 控制台是一个包含在 web 服务中的独立的应用，但是它也能作为一个servlet使用。为了做到这点，你需要将h2*.jar文件添加到你的应用中，在你的 web.xml 文件中增加下面的配置：

关于更多的细节，请参考src/tools/WEB-INF/web.xml

要创建一个合适的 H2 控制台的 web 应用，运行下面的命令：

  1. build warConsole

Android

Android 设备(使用Dalvik VM)上可以使用这个数据库代替 SQLite。到目前为止,只有很少的测试和基准测试运行,但似乎性能类似于 SQLite,除了打开和关闭数据库没有优化 (H2大约需要0.2秒,和SQLite约0.02秒)。读操作似乎比 SQLite 快,而写操作慢点。到目前为止,只有很少的测试运行,一切似乎正常工作。全文搜索还没有测试,然而本地的全文搜索应该能工作。

使用 H 2而不是 SQLite 原因是:

  • 全 Unicode 支持包括 UPPER() 和 LOWER()
  • 流 API 用于 BLOB 和 CLOB 数据
  • 全文搜索
  • 多连接
  • 用于定义方法和触发器
  • 数据库文件加密
  • 读写 CSV 文件 (该功能也可以在数据库外部使用)
  • 引用完整性和检查约束
  • 更好的数据类型和 SQL 支持
  • 内存数据库、只读数据库、表关联
  • 与其他数据库更好的兼容,简化应用程序移植
  • 可能更好的性能（对读操作）
  • 服务器模式(在不同的机器上通过 TCP/IP 访问同一个数据库)。

目前只支持 JDBC API (计划在将来的版本中支持 Android 数据库API)。常规的 H2 jar文件和小 h2small-*.jar 可以使用。为了创建更小的 jar 文件,运行命令./build.sh jarSmall (Linux / Mac OS) 或 build.bat jarSmall (Windows)

数据库文件需要存储在一个可以被一个应用程序访问的地方。例子:

  1. String url = "jdbc:h2:/data/data/" +
  2.     "com.example.hello" +
  3.     "/data/hello" +
  4.     ";FILE_LOCK=FS" +
  5.     ";PAGE_SIZE=1024" +
  6.     ";CACHE_SIZE=8192";
  7. Class.forName("org.h2.Driver");
  8. conn = DriverManager.getConnection(url);
  9. ...

限制:使用连接池目前不支持,因为所需的javax.sql 类是不在 Android 上的。

CSV (Comma Separated Values) 支持

CSV（逗号分隔文件）文件在数据库系统中支持CSVREAD和CSVWRITE方法，也可以把它作为数据库之外的一个工具来使用。将数据库查询结果写成CSV文件

使用 CSVREAD，例子：

  1. SELECT * FROM CSVREAD('test.csv');

请注意由于性能原因,CSVREAD 不应使用在 jion 内部。相反,先导入数据(可能到一个临时表),如果有必要创建所需的索引,然后查询这个表。

通过 CSV 文件导入数据

从CSV文件快速加载或导入数据(有时称为“批量加载”)的方法是结合表创建和导入。可选地,该列名称和数据类型可以在创建表时设置。另一个选项 INSERT INTO ... SELECT。

  1. CREATE TABLE TEST AS SELECT * FROM CSVREAD('test.csv');
  2. CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR(255))
  3.     AS SELECT * FROM CSVREAD('test.csv');

通过数据库写 CSV 文件

使用 CSVWRITE,

  1. CREATE TABLE TEST(ID INT, NAME VARCHAR);
  2. INSERT INTO TEST VALUES(1, 'Hello'), (2, 'World');
  3. CALL CSVWRITE('test.csv', 'SELECT * FROM TEST');

通过 Java 应用写 CSV 文件

使用 Csv 工具而无需数据库，

  1. import java.sql.*;
  2. import org.h2.tools.Csv;
  3. import org.h2.tools.SimpleResultSet;
  4. public class TestCsv {
  5.     public static void main(String[] args) throws Exception {
  6.         SimpleResultSet rs = new SimpleResultSet();
  7.         rs.addColumn("NAME", Types.VARCHAR, 255, 0);
  8.         rs.addColumn("EMAIL", Types.VARCHAR, 255, 0);
  9.         rs.addRow("Bob Meier", "bob.meier@abcde.abc");
  10.         rs.addRow("John Jones", "john.jones@abcde.abc");
  11.         new Csv().write("data/test.csv", rs, null);
  12.     }